home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / gnews203.zip / GNEWS203.DOC < prev    next >
Text File  |  1993-05-07  |  25KB  |  582 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                ▄█▀▀▀▀█▄
  24.                ██    ▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  25.                ██       ▀██▄ ▀██▀ ▀██▀▀▀▀▀ ▀██▀  ▀██▀ ▄█▀▀▀▀█
  26.                ██  ▄▄▄   ████▄██   ██▄▄▄    ██    ██  ▀█▄▄▄▄
  27.                ██    ██  ██ ▀███   ██       ██▄██▄██  ▄    ██
  28.                ██    ██ ▀▀▀▀  ▀▀▀ ▀▀▀▀▀▀▀▀   ▀▀  ▀▀   ▀▀▀▀▀▀
  29.                ██    ██ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  30.                 ▀▀▀▀▀▀
  31.                 News Maker, V2.03 by Gibi Cohen. 1991,92(c)
  32.  
  33.                   for:
  34.                       RemoteAccess , SuperBBS , QuickBBS
  35.  
  36.  
  37.  
  38.  
  39.  
  40.                  All programs mentioned in this documentation
  41.                  are owned by their respective owners.
  42.                  All programs are (C)opyrighted.
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.                                     - 2 -
  57.                      GNEWS v2.03, Documentation, 1991/92(C)
  58.  ══════════════════════════════════════════════════════════════════════════════
  59.  
  60.    GNEWS Files:
  61.    ────────────
  62.    The files listed below are part of GNEWS.  Depending on where you
  63.    obtained your copy, you may find the files in a compressed form,
  64.    usually in a file with the extension .ZIP, .ARJ or .LZH.
  65.    The original package is distributed as a Self-Extract file (with the
  66.    extension .EXE), created by Haruyasu Yoshizaki's LHA (tm).
  67.    These files may change from time to time.
  68.  
  69.    GNEWS.EXE       The GNEWS main program.
  70.    GNEWS203.DOC    GNEWS document file for version 2.03.
  71.    GNEWS.LIC       GNEWS license agreement.
  72.    GNEWS.REG       Registration form.
  73.    GNEWS.HIS       History of GNEWS releases.
  74.    GN_LOGO.BIN     Data file used by GNEWS.
  75.    NEWS.GNS        CTL file demo to create NEWS.AVT/ANS/ASC.
  76.    REPLACE.GNS     Demo file, to GNEWS String converting capability.
  77.    EXCLUDE.GNS     Demo file, to GNEWS Excluding capability.
  78.    NEWS.ANS        Demo file, to GNEWS output.
  79.    2to202.doc      Upgrade the CTL file.
  80.    202to203.doc    Upgrade the CTL file.
  81.    CRC32.EXE       Checksum for the files in this package.
  82.    CRC32.LST       List of original checksums I made.
  83.  
  84.    -NOTE CRC32.EXE is not for commercial use.
  85.  
  86.    License agreement:
  87.    ──────────────────
  88.    Please referee to GNEWS.LIC file in this package for a complete
  89.    license agreement.
  90.  
  91.    How to register
  92.    ───────────────
  93.    In order to register you must send me the registration form. Please
  94.    print the GNEWS.REG file, fill it properly, and send it to:
  95.  
  96.        Gibi Cohen,
  97.        P.O.Box 292
  98.        Kiryat-Motzkin
  99.        Zip Code: 26100
  100.        I S R A E L
  101.  
  102.    I will send you the latest version of GNEWS.
  103.  
  104.    What does it do...
  105.    ───────────────────
  106.    GNEWS was created to make reading messages simple and nice. It reads
  107.    the messages from your BBS message base and generate avatar, ansi & ascii
  108.    files that contains all messages read.
  109.    You can than use this files as news files or as any other regular bulletin
  110.    files.
  111.  
  112.  
  113.                                     - 3 -
  114.                      GNEWS v2.03, Documentation, 1991/92(C)
  115.  ══════════════════════════════════════════════════════════════════════════════
  116.  
  117.    How to install:
  118.    ───────────────
  119.    As you can see, there is no install batch/program for GNEWS, simply
  120.    because installation is a brief.
  121.    I suggest that GNEWS will be placed in a separate directory. Unpack
  122.    the GNEWS archive file into that directory.  It is also possible to
  123.    place GNEWS in your BBS system directory.
  124.  
  125.    GNEWS uses 2 environment variables:
  126.    (1) BBS environment variable, this variable contains the path
  127.    to your system directory.
  128.    You can set this variable by using the dos SET command, for example:
  129.    SET RA=C:\RA or,
  130.    SET SBBS=C:\SUPERBBS or,
  131.    SET QUICK=C:\QUICKBBS
  132.    If you prefer (from any reason) not to use this variable, you MUST place
  133.    GNEWS in your BBS system directory.
  134.  
  135.    (2) GNEWS environment variable contains the path to
  136.    GNEWS directory. If you decided to place GNEWS outside your BBS
  137.    system directory, you MUST set this variable to where GNEWS resides.
  138.    For example:  SET GNEWS=C:\BBSUTILS\GNEWS , and add the same for your PATH.
  139.  
  140.    (3) If you prefer not to use the above recommendations, you can run GNEWS
  141.         by specifying the Pull PathName in the Command-Line for example:
  142.  
  143.         C:\BBSUTILS\GNEWS\GNEWS <command-line>
  144.  
  145.         and GNEWS will locate it's files automatically.
  146.  
  147.    Remember all the following files MUST be in the same directory:
  148.      GNEWS.EXE, GN_LOGO.BIN, NEWS.GNS, REPLACE.GNS, EXCLUDE.GNS
  149.  
  150.  
  151.  
  152.                                     - 4 -
  153.                      GNEWS v2.03, Documentation, 1991/92(C)
  154.  ══════════════════════════════════════════════════════════════════════════════
  155.  
  156.   Running GNEWS :
  157.   ═══════════════
  158.  
  159.    -Note:
  160.     GNEWS truncate the message SUBJECT to 57 characters (originally 72 chars).
  161.  
  162.         CommandLine :
  163.         ─────────────
  164.         GNEWS CTLfile [/DV] /R|/S|/Q [/T|/F] [/?]
  165.  
  166.          CTLfile - The name of GNEWS control file (no extension).
  167.          /DV     - Force GNEWS to use BIOS screen writes when in DeskView,
  168.                     or other multitasking environment.
  169.          /R      - Use RemoteAccess environment.
  170.          /S      - Use SuperBBS v1.16 and later.
  171.          /S15    - Use SuperBBS v1.15 and earlier.
  172.          /Q      - Use QuickBBS environment.
  173.          /T      - Process only the messages that were sent to a specific user
  174.                     for example:
  175.                     /T=All  will process only messages that were sent
  176.                             to All users.
  177.                     /T=Roger_Rabbit will process only messages that
  178.                             were sent to Roger Rabbit.
  179.          /F      - Same as /T but refers only to messages that were sent FROM
  180.                     the specified user.
  181.                     /F=Micky_Mouse
  182.         /?       - Brief summery of command-line parameters.
  183.  
  184.         The 3 Output Files that GNEWS will create will have the same
  185.         name as the CTLfile, with .AVT / .ANS / .ASC extensions.
  186.  
  187.         Printing Messages :
  188.         ───────────────────
  189.         GNEWS is capable of printing messages to printer.
  190.         The SysOp can define a special message-area where every message
  191.          that will be posted to it will be printed by GNEWS and will be
  192.          marked 'RECEIVED'.
  193.         The best way to utilize this option is to place the following command
  194.          in your BBS batch file, just before the BBS load command:
  195.  
  196.          GNEWS ScanArea /ExMail [/S:] [/E:] [/FF]
  197.  
  198.           ScanArea - Area number that contains the messages to be printed.
  199.            /ExMail - Express mail, tell GNEWS to process Messages
  200.                       to printer (LPT1).
  201.            /S:     - StartTime, GNEWS will not print before this hour.
  202.            /E:     - EndTime,   GNEWS will not print after this hour.
  203.            /FF     - FormFeed,  GNEWS will send a Form Feed command to the
  204.                                 printer after each message.
  205.  
  206.          For example: GNEWS 167 /ExMail /S:0900 /E:2300
  207.           Will scan area 167 and print the messages if current time is
  208.           between 9:00 am to 11:00 pm.
  209.  
  210.   ┌───────────────────────────────────────────────────────────────────────┐
  211.   │- IMPORTANT NOTE !!! -                                                 │
  212.   │ In multi-line systems DO NOT run GNEWS while other users are On-Line, │
  213.   │  results may be unpredictable.                                        │
  214.   │ If another On-Line user is updating any of your BBS files while GNEWS │
  215.   │  is running, sharing conflicts may cause damage to your files.        │
  216.   └───────────────────────────────────────────────────────────────────────┘
  217.  
  218.  
  219.                                     - 5 -
  220.  
  221.                      GNEWS v2.03, Documentation, 1991/92(C)
  222.  
  223.  ══════════════════════════════════════════════════════════════════════════════
  224.  
  225.   Commands & Switches in the Control file :
  226.   ═════════════════════════════════════════
  227.  
  228.   (*** Options marked with {+} are Registered only ***)
  229.  
  230.         AsciiFile = tru